import polars as pl

df1 = pl.DataFrame({"id": [1, 2], "x": [3, 4]})
df2 = pl.DataFrame({"id": [2, 3], "y": [5, 6]})
df3 = pl.DataFrame({"id": [1, 3], "z": [7, 8]})

pl.concat([df1, df2, df3], how="align_full")
# shape: (3, 4)
# ┌─────┬──────┬──────┬──────┐
# │ id  ┆ x    ┆ y    ┆ z    │
# │ --- ┆ ---  ┆ ---  ┆ ---  │
# │ i64 ┆ i64  ┆ i64  ┆ i64  │
# ╞═════╪══════╪══════╪══════╡
# │ 1   ┆ 3    ┆ null ┆ 7    │
# │ 2   ┆ 4    ┆ 5    ┆ null │
# │ 3   ┆ null ┆ 6    ┆ 8    │
# └─────┴──────┴──────┴──────┘

pl.concat([df1, df2, df3], how="align_left")
# shape: (2, 4)
# ┌─────┬─────┬──────┬──────┐
# │ id  ┆ x   ┆ y    ┆ z    │
# │ --- ┆ --- ┆ ---  ┆ ---  │
# │ i64 ┆ i64 ┆ i64  ┆ i64  │
# ╞═════╪═════╪══════╪══════╡
# │ 1   ┆ 3   ┆ null ┆ 7    │
# │ 2   ┆ 4   ┆ 5    ┆ null │
# └─────┴─────┴──────┴──────┘

pl.concat([df1, df2, df3], how="align_right")
# shape: (2, 4)
# ┌─────┬──────┬──────┬─────┐
# │ id  ┆ x    ┆ y    ┆ z   │
# │ --- ┆ ---  ┆ ---  ┆ --- │
# │ i64 ┆ i64  ┆ i64  ┆ i64 │
# ╞═════╪══════╪══════╪═════╡
# │ 1   ┆ null ┆ null ┆ 7   │
# │ 3   ┆ null ┆ 6    ┆ 8   │
# └─────┴──────┴──────┴─────┘

pl.concat([df1, df2, df3], how="align_inner")
# shape: (0, 4)
# ┌─────┬─────┬─────┬─────┐
# │ id  ┆ x   ┆ y   ┆ z   │
# │ --- ┆ --- ┆ --- ┆ --- │
# │ i64 ┆ i64 ┆ i64 ┆ i64 │
# ╞═════╪═════╪═════╪═════╡
# └─────┴─────┴─────┴─────┘